DrawThemePopupArrow

DrawThemePopupArrow
Header:	Appearance.h		Carbon status:	Supported

Draws a pop-up arrow.

OSStatus DrawThemePopupArrow (
    const Rect *bounds, 
    ThemeArrowOrientation orientation, 
    ThemePopupArrowSize size, 
    ThemeDrawState state, 
    ThemeEraseUPP eraseProc, 
    UInt32 eraseData
);

bounds: A pointer to a structure of type Rect. Before calling DrawThemePopupArrow, set the rectangle to contain the arrow, in local coordinates. DrawThemePopupArrow positions the arrow relative to the top left corner of the rectangle.
orientation: A value of type ThemeArrowOrientation. Pass a constant specifying the direction in which the pop-up arrow points. See “Theme Pop-Up Arrow Orientation Constants” for descriptions of possible values.
size: A value of type ThemePopupArrowSize. Pass a constant specifying the size of the pop-up arrow to draw. See “Theme Pop-Up Arrow Size Constants” for descriptions of possible values.
state: A value of type ThemeDrawState. Pass a constant specifying the current state of the button containing the pop-up arrow. See “Theme Draw State Constants” for descriptions of possible values.
eraseProc: A value of type ThemeEraseUPP. If you have a custom background, pass a universal function pointer to an application-defined function such as that described in ThemeEraseProcPtr. DrawThemePopupArrow calls that function to erase the background before drawing the pop-up arrow. If you pass NULL, no erasing occurs.
eraseData: An unsigned 32-bit integer. Provide any data to be passed in to the eraseData parameter of the callback function specified in the eraseProc parameter.

function result: A result code.

DISCUSSION

The DrawThemePopupArrow function draws a theme-compliant pop-up arrow. A pop-up arrow is an image drawn onto another control to indicate that when the control is clicked, you get a pop-up menu. A pop-up arrow is not a separate button itself. Typically, a pop-up arrow is used in conjunction with a button, such as a push button or bevel button. Bevel button controls automatically draw a pop-up arrow if a menu is associated with the control.

VERSION NOTES

This function is available with Appearance Manager 1.1 and later.

AVAILABILITY

Supported in Carbon. Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.